<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkTable</title>
<meta name="generator" content="DocBook XSL Stylesheets V1.76.1">
<link rel="home" href="index.html" title="GTK+ 2 Reference Manual">
<link rel="up" href="LayoutContainers.html" title="Layout Containers">
<link rel="prev" href="GtkNotebook.html" title="GtkNotebook">
<link rel="next" href="GtkExpander.html" title="GtkExpander">
<meta name="generator" content="GTK-Doc V1.18 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
<tr valign="middle">
<td><a accesskey="p" href="GtkNotebook.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
<td><a accesskey="u" href="LayoutContainers.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
<th width="100%" align="center">GTK+ 2 Reference Manual</th>
<td><a accesskey="n" href="GtkExpander.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
</tr>
<tr><td colspan="5" class="shortcuts">
<a href="#GtkTable.synopsis" class="shortcut">Top</a>
                   | 
                  <a href="#GtkTable.description" class="shortcut">Description</a>
                   | 
                  <a href="#GtkTable.object-hierarchy" class="shortcut">Object Hierarchy</a>
                   | 
                  <a href="#GtkTable.implemented-interfaces" class="shortcut">Implemented Interfaces</a>
                   | 
                  <a href="#GtkTable.properties" class="shortcut">Properties</a>
                   | 
                  <a href="#GtkTable.child-properties" class="shortcut">Child Properties</a>
</td></tr>
</table>
<div class="refentry">
<a name="GtkTable"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkTable.top_of_page"></a>GtkTable</span></h2>
<p>GtkTable — Pack widgets in regular patterns</p>
</td>
<td valign="top" align="right"></td>
</tr></table></div>
<div class="refsynopsisdiv">
<a name="GtkTable.synopsis"></a><h2>Synopsis</h2>
<pre class="synopsis">
#include &lt;gtk/gtk.h&gt;

struct              <a class="link" href="GtkTable.html#GtkTable-struct" title="struct GtkTable">GtkTable</a>;
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         <a class="link" href="GtkTable.html#gtk-table-new" title="gtk_table_new ()">gtk_table_new</a>                       (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> rows</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> columns</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> homogeneous</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-resize" title="gtk_table_resize ()">gtk_table_resize</a>                    (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> rows</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> columns</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-attach" title="gtk_table_attach ()">gtk_table_attach</a>                    (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> left_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> right_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> top_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> bottom_attach</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a> xoptions</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a> yoptions</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> xpadding</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> ypadding</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-attach-defaults" title="gtk_table_attach_defaults ()">gtk_table_attach_defaults</a>           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> left_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> right_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> top_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> bottom_attach</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-set-row-spacing" title="gtk_table_set_row_spacing ()">gtk_table_set_row_spacing</a>           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> row</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> spacing</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-set-col-spacing" title="gtk_table_set_col_spacing ()">gtk_table_set_col_spacing</a>           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> column</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> spacing</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-set-row-spacings" title="gtk_table_set_row_spacings ()">gtk_table_set_row_spacings</a>          (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> spacing</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-set-col-spacings" title="gtk_table_set_col_spacings ()">gtk_table_set_col_spacings</a>          (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> spacing</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-set-homogeneous" title="gtk_table_set_homogeneous ()">gtk_table_set_homogeneous</a>           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> homogeneous</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkTable.html#gtk-table-get-default-row-spacing" title="gtk_table_get_default_row_spacing ()">gtk_table_get_default_row_spacing</a>   (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            <a class="link" href="GtkTable.html#gtk-table-get-homogeneous" title="gtk_table_get_homogeneous ()">gtk_table_get_homogeneous</a>           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkTable.html#gtk-table-get-row-spacing" title="gtk_table_get_row_spacing ()">gtk_table_get_row_spacing</a>           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> row</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkTable.html#gtk-table-get-col-spacing" title="gtk_table_get_col_spacing ()">gtk_table_get_col_spacing</a>           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> column</code></em>);
<a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               <a class="link" href="GtkTable.html#gtk-table-get-default-col-spacing" title="gtk_table_get_default_col_spacing ()">gtk_table_get_default_col_spacing</a>   (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>);
<span class="returnvalue">void</span>                <a class="link" href="GtkTable.html#gtk-table-get-size" title="gtk_table_get_size ()">gtk_table_get_size</a>                  (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *rows</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *columns</code></em>);
</pre>
</div>
<div class="refsect1">
<a name="GtkTable.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="synopsis">
  <a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GObject">GObject</a>
   +----<a href="http://library.gnome.org/devel/gobject/unstable/gobject-The-Base-Object-Type.html#GInitiallyUnowned">GInitiallyUnowned</a>
         +----<a class="link" href="GtkObject.html" title="GtkObject">GtkObject</a>
               +----<a class="link" href="GtkWidget.html" title="GtkWidget">GtkWidget</a>
                     +----<a class="link" href="GtkContainer.html" title="GtkContainer">GtkContainer</a>
                           +----GtkTable
</pre>
</div>
<div class="refsect1">
<a name="GtkTable.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkTable implements
 AtkImplementorIface and  <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkTable.properties"></a><h2>Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkTable.html#GtkTable--column-spacing" title='The "column-spacing" property'>column-spacing</a>"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--homogeneous" title='The "homogeneous" property'>homogeneous</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--n-columns" title='The "n-columns" property'>n-columns</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--n-rows" title='The "n-rows" property'>n-rows</a>"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--row-spacing" title='The "row-spacing" property'>row-spacing</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
</pre>
</div>
<div class="refsect1">
<a name="GtkTable.child-properties"></a><h2>Child Properties</h2>
<pre class="synopsis">
  "<a class="link" href="GtkTable.html#GtkTable--c-bottom-attach" title='The "bottom-attach" child property'>bottom-attach</a>"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--c-left-attach" title='The "left-attach" child property'>left-attach</a>"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--c-right-attach" title='The "right-attach" child property'>right-attach</a>"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--c-top-attach" title='The "top-attach" child property'>top-attach</a>"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--c-x-options" title='The "x-options" child property'>x-options</a>"                <a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a>      : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--c-x-padding" title='The "x-padding" child property'>x-padding</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--c-y-options" title='The "y-options" child property'>y-options</a>"                <a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a>      : Read / Write
  "<a class="link" href="GtkTable.html#GtkTable--c-y-padding" title='The "y-padding" child property'>y-padding</a>"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write
</pre>
</div>
<div class="refsect1">
<a name="GtkTable.description"></a><h2>Description</h2>
<p>
The <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> functions allow the programmer to arrange widgets in rows and
columns, making it easy to align many widgets next to each other,
horizontally and vertically.
</p>
<p>
Tables are created with a call to <a class="link" href="GtkTable.html#gtk-table-new" title="gtk_table_new ()"><code class="function">gtk_table_new()</code></a>, the size of which can
later be changed with <a class="link" href="GtkTable.html#gtk-table-resize" title="gtk_table_resize ()"><code class="function">gtk_table_resize()</code></a>.
</p>
<p>
Widgets can be added to a table using <a class="link" href="GtkTable.html#gtk-table-attach" title="gtk_table_attach ()"><code class="function">gtk_table_attach()</code></a> or the more
convenient (but slightly less flexible) <a class="link" href="GtkTable.html#gtk-table-attach-defaults" title="gtk_table_attach_defaults ()"><code class="function">gtk_table_attach_defaults()</code></a>.
</p>
<p>
To alter the space next to a specific row, use <a class="link" href="GtkTable.html#gtk-table-set-row-spacing" title="gtk_table_set_row_spacing ()"><code class="function">gtk_table_set_row_spacing()</code></a>,
and for a column, <a class="link" href="GtkTable.html#gtk-table-set-col-spacing" title="gtk_table_set_col_spacing ()"><code class="function">gtk_table_set_col_spacing()</code></a>.</p>
<p>
The gaps between <span class="emphasis"><em>all</em></span> rows or columns can be changed by calling
<a class="link" href="GtkTable.html#gtk-table-set-row-spacings" title="gtk_table_set_row_spacings ()"><code class="function">gtk_table_set_row_spacings()</code></a> or <a class="link" href="GtkTable.html#gtk-table-set-col-spacings" title="gtk_table_set_col_spacings ()"><code class="function">gtk_table_set_col_spacings()</code></a> respectively.
</p>
<p>
<a class="link" href="GtkTable.html#gtk-table-set-homogeneous" title="gtk_table_set_homogeneous ()"><code class="function">gtk_table_set_homogeneous()</code></a>, can be used to set whether all cells in the
table will resize themselves to the size of the largest widget in the table.
</p>
</div>
<div class="refsect1">
<a name="GtkTable.details"></a><h2>Details</h2>
<div class="refsect2">
<a name="GtkTable-struct"></a><h3>struct GtkTable</h3>
<pre class="programlisting">struct GtkTable;</pre>
<p>
The <span class="structname">GtkTable</span> structure holds the data for the actual table itself.
<em class="structfield"><code>children</code></em> is a <a href="http://library.gnome.org/devel/glib/unstable/glib-Doubly-Linked-Lists.html#GList"><span class="type">GList</span></a> of all the widgets the table contains. <em class="structfield"><code>rows</code></em> and <em class="structfield"><code>columns</code></em> are pointers to <span class="type">GtkTableRowCol</span> structures, which contain the default spacing and expansion details for the <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>'s rows and columns, respectively.
</p>
<p>
<em class="structfield"><code>nrows</code></em> and <em class="structfield"><code>ncols</code></em> are 16bit integers storing the number of rows and columns the table has.
</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-new"></a><h3>gtk_table_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *         gtk_table_new                       (<em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> rows</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> columns</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> homogeneous</code></em>);</pre>
<p>
Used to create a new table widget. An initial size must be given by
specifying how many rows and columns the table should have, although
this can be changed later with <a class="link" href="GtkTable.html#gtk-table-resize" title="gtk_table_resize ()"><code class="function">gtk_table_resize()</code></a>.  <em class="parameter"><code>rows</code></em> and <em class="parameter"><code>columns</code></em>
must both be in the range 1 .. 65535. For historical reasons, 0 is accepted
as well and is silently interpreted as 1.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>rows</code></em> :</span></p></td>
<td>The number of rows the new table should have.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>columns</code></em> :</span></p></td>
<td>The number of columns the new table should have.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>homogeneous</code></em> :</span></p></td>
<td>If set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a>, all table cells are resized to the size of the cell
containing the largest widget.</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>A pointer to the the newly created table widget.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-resize"></a><h3>gtk_table_resize ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_resize                    (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> rows</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> columns</code></em>);</pre>
<p>
If you need to change a table's size <span class="emphasis"><em>after</em></span> it has been created, this function allows you to do so.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>The <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> you wish to change the size of.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>rows</code></em> :</span></p></td>
<td>The new number of rows.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>columns</code></em> :</span></p></td>
<td>The new number of columns.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-attach"></a><h3>gtk_table_attach ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_attach                    (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *child</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> left_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> right_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> top_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> bottom_attach</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a> xoptions</code></em>,
                                                         <em class="parameter"><code><a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a> yoptions</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> xpadding</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> ypadding</code></em>);</pre>
<p>
Adds a widget to a table. The number of 'cells' that a widget will occupy is
specified by <em class="parameter"><code>left_attach</code></em>, <em class="parameter"><code>right_attach</code></em>, <em class="parameter"><code>top_attach</code></em> and <em class="parameter"><code>bottom_attach</code></em>.
These each represent the leftmost, rightmost, uppermost and lowest column
and row numbers of the table. (Columns and rows are indexed from zero).
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>The <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> to add a new widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>child</code></em> :</span></p></td>
<td>The widget to add.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>left_attach</code></em> :</span></p></td>
<td>the column number to attach the left side of a child widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>right_attach</code></em> :</span></p></td>
<td>the column number to attach the right side of a child widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>top_attach</code></em> :</span></p></td>
<td>the row number to attach the top of a child widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>bottom_attach</code></em> :</span></p></td>
<td>the row number to attach the bottom of a child widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>xoptions</code></em> :</span></p></td>
<td>Used to specify the properties of the child widget when the table is resized.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>yoptions</code></em> :</span></p></td>
<td>The same as xoptions, except this field determines behaviour of vertical resizing.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>xpadding</code></em> :</span></p></td>
<td>An integer value specifying the padding on the left and right of the widget being added to the table.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>ypadding</code></em> :</span></p></td>
<td>The amount of padding above and below the child widget.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-attach-defaults"></a><h3>gtk_table_attach_defaults ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_attach_defaults           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="type">GtkWidget</span></a> *widget</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> left_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> right_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> top_attach</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> bottom_attach</code></em>);</pre>
<p>
As there are many options associated with <a class="link" href="GtkTable.html#gtk-table-attach" title="gtk_table_attach ()"><code class="function">gtk_table_attach()</code></a>, this convenience function provides the programmer with a means to add children to a table with identical padding and expansion options. The values used for the <a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a> are <code class="literal">GTK_EXPAND | GTK_FILL</code>, and the padding is set to 0.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>The table to add a new child widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>widget</code></em> :</span></p></td>
<td>The child widget to add.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>left_attach</code></em> :</span></p></td>
<td>The column number to attach the left side of the child widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>right_attach</code></em> :</span></p></td>
<td>The column number to attach the right side of the child widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>top_attach</code></em> :</span></p></td>
<td>The row number to attach the top of the child widget to.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>bottom_attach</code></em> :</span></p></td>
<td>The row number to attach the bottom of the child widget to.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-set-row-spacing"></a><h3>gtk_table_set_row_spacing ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_set_row_spacing           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> row</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> spacing</code></em>);</pre>
<p>
Changes the space between a given table row and the subsequent row.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> containing the row whose properties you wish to change.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>row</code></em> :</span></p></td>
<td>row number whose spacing will be changed.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>spacing</code></em> :</span></p></td>
<td>number of pixels that the spacing should take up.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-set-col-spacing"></a><h3>gtk_table_set_col_spacing ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_set_col_spacing           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> column</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> spacing</code></em>);</pre>
<p>
Alters the amount of space between a given table column and the following
column.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>column</code></em> :</span></p></td>
<td>the column whose spacing should be changed.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>spacing</code></em> :</span></p></td>
<td>number of pixels that the spacing should take up.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-set-row-spacings"></a><h3>gtk_table_set_row_spacings ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_set_row_spacings          (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> spacing</code></em>);</pre>
<p>
Sets the space between every row in <em class="parameter"><code>table</code></em> equal to <em class="parameter"><code>spacing</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>spacing</code></em> :</span></p></td>
<td>the number of pixels of space to place between every row in the table.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-set-col-spacings"></a><h3>gtk_table_set_col_spacings ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_set_col_spacings          (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> spacing</code></em>);</pre>
<p>
Sets the space between every column in <em class="parameter"><code>table</code></em> equal to <em class="parameter"><code>spacing</code></em>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>spacing</code></em> :</span></p></td>
<td>the number of pixels of space to place between every column in the table.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-set-homogeneous"></a><h3>gtk_table_set_homogeneous ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_set_homogeneous           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a> homogeneous</code></em>);</pre>
<p>
Changes the homogenous property of table cells, ie. whether all cells are an equal size or not.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>The <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> you wish to set the homogeneous properties of.</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>homogeneous</code></em> :</span></p></td>
<td>Set to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> to ensure all table cells are the same size. Set
to <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#FALSE:CAPS"><code class="literal">FALSE</code></a> if this is not your desired behaviour.</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-get-default-row-spacing"></a><h3>gtk_table_get_default_row_spacing ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_table_get_default_row_spacing   (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>);</pre>
<p>
Gets the default row spacing for the table. This is
the spacing that will be used for newly added rows.
(See <a class="link" href="GtkTable.html#gtk-table-set-row-spacings" title="gtk_table_set_row_spacings ()"><code class="function">gtk_table_set_row_spacings()</code></a>)
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the default row spacing</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-get-homogeneous"></a><h3>gtk_table_get_homogeneous ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="returnvalue">gboolean</span></a>            gtk_table_get_homogeneous           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>);</pre>
<p>
Returns whether the table cells are all constrained to the same
width and height. (See <code class="function">gtk_table_set_homogenous()</code>)
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>
<a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#TRUE:CAPS"><code class="literal">TRUE</code></a> if the cells are all constrained to the same size</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-get-row-spacing"></a><h3>gtk_table_get_row_spacing ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_table_get_row_spacing           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> row</code></em>);</pre>
<p>
Gets the amount of space between row <em class="parameter"><code>row</code></em>, and
row <em class="parameter"><code>row</code></em> + 1. See <a class="link" href="GtkTable.html#gtk-table-set-row-spacing" title="gtk_table_set_row_spacing ()"><code class="function">gtk_table_set_row_spacing()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>row</code></em> :</span></p></td>
<td>a row in the table, 0 indicates the first row</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the row spacing</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-get-col-spacing"></a><h3>gtk_table_get_col_spacing ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_table_get_col_spacing           (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> column</code></em>);</pre>
<p>
Gets the amount of space between column <em class="parameter"><code>col</code></em>, and
column <em class="parameter"><code>col</code></em> + 1. See <a class="link" href="GtkTable.html#gtk-table-set-col-spacing" title="gtk_table_set_col_spacing ()"><code class="function">gtk_table_set_col_spacing()</code></a>.
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>column</code></em> :</span></p></td>
<td>a column in the table, 0 indicates the first column</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the column spacing</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-get-default-col-spacing"></a><h3>gtk_table_get_default_col_spacing ()</h3>
<pre class="programlisting"><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="returnvalue">guint</span></a>               gtk_table_get_default_col_spacing   (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>);</pre>
<p>
Gets the default column spacing for the table. This is
the spacing that will be used for newly added columns.
(See <a class="link" href="GtkTable.html#gtk-table-set-col-spacings" title="gtk_table_set_col_spacings ()"><code class="function">gtk_table_set_col_spacings()</code></a>)
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
<td>the default column spacing</td>
</tr>
</tbody>
</table></div>
</div>
<hr>
<div class="refsect2">
<a name="gtk-table-get-size"></a><h3>gtk_table_get_size ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>                gtk_table_get_size                  (<em class="parameter"><code><a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a> *table</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *rows</code></em>,
                                                         <em class="parameter"><code><a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a> *columns</code></em>);</pre>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><em class="parameter"><code>table</code></em> :</span></p></td>
<td>a <a class="link" href="GtkTable.html" title="GtkTable"><span class="type">GtkTable</span></a>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>rows</code></em> :</span></p></td>
<td>return location for the number of
rows, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
<tr>
<td><p><span class="term"><em class="parameter"><code>columns</code></em> :</span></p></td>
<td>return location for the number
of columns, or <a href="http://library.gnome.org/devel/glib/unstable/glib-Standard-Macros.html#NULL:CAPS"><code class="literal">NULL</code></a>. <span class="annotation">[<acronym title="Parameter for returning results. Default is transfer full."><span class="acronym">out</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
</td>
</tr>
</tbody>
</table></div>
<p class="since">Since 2.22</p>
</div>
</div>
<div class="refsect1">
<a name="GtkTable.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkTable--column-spacing"></a><h3>The <code class="literal">"column-spacing"</code> property</h3>
<pre class="programlisting">  "column-spacing"           <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>The amount of space between two consecutive columns.</p>
<p>Allowed values: &lt;= 65535</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--homogeneous"></a><h3>The <code class="literal">"homogeneous"</code> property</h3>
<pre class="programlisting">  "homogeneous"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#gboolean"><span class="type">gboolean</span></a>              : Read / Write</pre>
<p>If TRUE, the table cells are all the same width/height.</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--n-columns"></a><h3>The <code class="literal">"n-columns"</code> property</h3>
<pre class="programlisting">  "n-columns"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>The number of columns in the table.</p>
<p>Allowed values: [1,65535]</p>
<p>Default value: 1</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--n-rows"></a><h3>The <code class="literal">"n-rows"</code> property</h3>
<pre class="programlisting">  "n-rows"                   <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>The number of rows in the table.</p>
<p>Allowed values: [1,65535]</p>
<p>Default value: 1</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--row-spacing"></a><h3>The <code class="literal">"row-spacing"</code> property</h3>
<pre class="programlisting">  "row-spacing"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>The amount of space between two consecutive rows.</p>
<p>Allowed values: &lt;= 65535</p>
<p>Default value: 0</p>
</div>
</div>
<div class="refsect1">
<a name="GtkTable.child-property-details"></a><h2>Child Property Details</h2>
<div class="refsect2">
<a name="GtkTable--c-bottom-attach"></a><h3>The <code class="literal">"bottom-attach"</code> child property</h3>
<pre class="programlisting">  "bottom-attach"            <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>The row number to attach the bottom of the child to.</p>
<p>Allowed values: [1,65535]</p>
<p>Default value: 1</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--c-left-attach"></a><h3>The <code class="literal">"left-attach"</code> child property</h3>
<pre class="programlisting">  "left-attach"              <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>The column number to attach the left side of the child to.</p>
<p>Allowed values: &lt;= 65535</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--c-right-attach"></a><h3>The <code class="literal">"right-attach"</code> child property</h3>
<pre class="programlisting">  "right-attach"             <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>The column number to attach the right side of a child widget to.</p>
<p>Allowed values: [1,65535]</p>
<p>Default value: 1</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--c-top-attach"></a><h3>The <code class="literal">"top-attach"</code> child property</h3>
<pre class="programlisting">  "top-attach"               <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>The row number to attach the top of a child widget to.</p>
<p>Allowed values: &lt;= 65535</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--c-x-options"></a><h3>The <code class="literal">"x-options"</code> child property</h3>
<pre class="programlisting">  "x-options"                <a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a>      : Read / Write</pre>
<p>Options specifying the horizontal behaviour of the child.</p>
<p>Default value: GTK_EXPAND|GTK_FILL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--c-x-padding"></a><h3>The <code class="literal">"x-padding"</code> child property</h3>
<pre class="programlisting">  "x-padding"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>Extra space to put between the child and its left and right neighbors, in pixels.</p>
<p>Allowed values: &lt;= 65535</p>
<p>Default value: 0</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--c-y-options"></a><h3>The <code class="literal">"y-options"</code> child property</h3>
<pre class="programlisting">  "y-options"                <a class="link" href="gtk-Standard-Enumerations.html#GtkAttachOptions" title="enum GtkAttachOptions"><span class="type">GtkAttachOptions</span></a>      : Read / Write</pre>
<p>Options specifying the vertical behaviour of the child.</p>
<p>Default value: GTK_EXPAND|GTK_FILL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkTable--c-y-padding"></a><h3>The <code class="literal">"y-padding"</code> child property</h3>
<pre class="programlisting">  "y-padding"                <a href="http://library.gnome.org/devel/glib/unstable/glib-Basic-Types.html#guint"><span class="type">guint</span></a>                 : Read / Write</pre>
<p>Extra space to put between the child and its upper and lower neighbors, in pixels.</p>
<p>Allowed values: &lt;= 65535</p>
<p>Default value: 0</p>
</div>
</div>
<div class="refsect1">
<a name="GtkTable.see-also"></a><h2>See Also</h2>
<p>
</p>
<div class="variablelist"><table border="0">
<col align="left" valign="top">
<tbody>
<tr>
<td><p><span class="term"><a class="link" href="GtkVBox.html" title="GtkVBox"><span class="type">GtkVBox</span></a></span></p></td>
<td><p>For packing widgets vertically only.</p></td>
</tr>
<tr>
<td><p><span class="term"><a class="link" href="GtkHBox.html" title="GtkHBox"><span class="type">GtkHBox</span></a></span></p></td>
<td><p>For packing widgets horizontally only.</p></td>
</tr>
</tbody>
</table></div>
<p>
</p>
</div>
</div>
<div class="footer">
<hr>
          Generated by GTK-Doc V1.18</div>
</body>
</html>